# Droney

_Drone CI on any computer in the world!_

--------------------

Easy, configurable bash scripts to automate a Drone CI instance without any dedicated servers or domains - on any computer in the world!


## Features

- Configurable - saves from repeated steps and nearly fail-proof
- Easy to use - configure once and forget
- Works on any computer - doesn't require buying a VPS, or domain
- Auto free subdomain for accessing your Drone UI
- Supported platforms:
  - Gitea (codeberg.org etc.)


## Usage

Make sure you have installed:
- [docker](https://docs.docker.com/get-docker/)
- a local tunneling service:
  - [pgrok](https://github.com/jerson/pgrok/releases)
  - [localtunnel](https://github.com/localtunnel/localtunnel/releases)
  - [tunnelto](https://github.com/agrinman/tunnelto/releases)

Consult [installation documentation](docs/install.md) for detailed instructions.

```sh
git clone https://notabug.org/adnan360/droney.git
cd droney
cp -i config.sample.sh config.sh
nano config.sh
./start.sh
```

It should show you an URL. Make sure it's set in your [OAuth2 Application](docs/config.md#oauth2-setup). Now go to the URL to access Drone UI, click Sync and activate the repos you want Drone to work on.

Commit a `.drone.yml` in that repo with something like:

```yaml
kind: pipeline
type: docker
name: default

steps:
- name: greeting
  image: alpine
  commands:
  - echo hello
  - echo world
```

It should show up on Drone UI and the build process will be shown.

When you no longer need Drone running, stop it:

```sh
./stop.sh
```


#### License

MIT (Expat) License

**Note:** Not an official project of Drone CI.
